Form Field IDs for Cargo Appointments

You can use the following form fields to design the gate forms for data entry for the Deliver Break-Bulk (DB) and Receive Break-Bulk (RB) gate transaction types at the appointment gate stages. In addition to the fields listed below, you can add the BL, BL Item, and Cargo Lot flex fields for the DB and RB transaction types at various gate stages. All BL, BL Item, and Cargo Lot flex fields are view-only fields in the gate transaction form.Cargo Item Move Quantity

 

Agent1

Displays a lookup field of agent IDs for a user to select the agent in an appointment form.

To save the selected agent ID for a pre-advised unit when creating an appointment, include the CreateContainerPreadviseVisit business task in the Appt Tran Type form.

 

Agent2

Displays a lookup field of agent IDs for a user to select a second agent in an appointment form.

To save the selected agent ID for a pre-advised unit when creating an appointment, include the CreateContainerPreadviseVisit business task in the Appt Tran Type form.

 

Booking Item

Displays a drop-down list of equipment order (Booking, EDO) items, specified for an equipment order, in a gate form.

N4 automatically fills in the equipment order items specified on an equipment order (Booking, EDO) when the clerk does one of the following:

For hazardous order items, the Booking Item field's list of values display the IMDG class and UN number. This enables you to select the appropriate order item when an order contains more than one hazardous order item.

If the Order Item Not Unique check box is selected for a line operator, N4 tries to match the order item, if possible. If multiple non-unique order items exist, N4 displays an error message and the user must select the appropriate order item. For more information on the Order Item Not Unique check box, see the Booking Rules tab.

For a Receive Export (RE) or Deliver Empty (DM) gate transaction, when a clerk selects the Booking Item, the existing equipment order item data will pre-populate in the following fields,

If these fields are also displayed on the gate form.

Notes

 

Booking Number

Displays a text field for the gate clerk to enter an order number (booking, EDO, ERO, or rail order) in the gate form. Unlike the Booking/Order lookup field, the Booking Number field does not display a list of values while the gate clerk enters the order number.

If you use the SelectExportContainer business task, XPS will select the best available dray-off export container in the yard based on the value entered in the Booking Number field.

If the Booking Number field does not display a list of values with the line operator

If a line operator allows duplicate booking numbers and multiple orders with the same number are present, the Booking Number field does not display a list of values with the line operator or Vessel Visit to help you identify the correct order. Therefore, Navis recommends that you add the Line ID field to the gate form before the Booking Number field.

However, if N4 finds duplicate booking numbers, such as an EDO and ERO for same line operator, then N4 displays the Duplicates Found - Please Select From The List form asking the clerk to select the correct booking. This form displays the Number, Sub Type, Facility, Line Op, and Ves. Visit fields for the duplicate bookings found.

Pre-populated fields

If the following fields are included in the gate form, the existing data is automatically filled in when a gate clerk enters an order number in the Booking Number field:

If a gate clerk enters a pre-advised container number, then N4 automatically fills in the Booking Number field with the pre-advised order number.

Booking/Order - Appointment

Displays a lookup field of equipment order (Booking, EDO, or ERO) numbers in an appointment form.

The Booking/Order field list of values displays only the equipment orders for the operating line entered in the Line Operator field on the appointment form. For an EDO, the Booking/Order lookup field displays the Line ID and Facility name in parenthesis after the order number to help you identify the correct facility the EDO is created for. If the EDO is created at the Complex scope level, the list does not display facility name in the parenthesis.

If the following fields are included in the appointment form, N4 automatically fills existing data when a user selects an equipment order from the Booking/Order lookup field:

Cargo Bill Of Lading

Displays a lookup field for the user to select the Bill of Lading Number for the break-bulk gate transaction type. If the Cargo BL Item (on page 1) field is also included in the form, N4 displays the BL items associated with the selected BL. If there is only one BL Item defined for the selected BL, N4 automatically fills in the Cargo BL Item field.

Similarly, if the Cargo Delivery Order (on page 1) field is included in the gate form, N4 restricts the BL numbers available for the user to select.

When you receive a break-bulk unit against a BL, N4 copies the O/B Carrier Visit and the POD of the BL to the unit and the gate transaction.

 

Cargo BL Item

Displays a lookup field for the user to select the Bill of Lading Item Number for the break-bulk gate transaction type. If the selected bill of lading (on page 1) has only one BL Item, N4 automatically displays the BL Item in this field. N4 lists BL items even after the associated cargo lots have departed.

 

Cargo Delivery Order

Displays a lookup field for the user to select the Delivery Order Number for the break-bulk gate transaction type. If the Cargo Delivery Order Item (on page 1) field is also included in the gate form, N4 displays the delivery order items associated with the selected delivery order. If only one item is associated with the delivery order, N4 automatically fills in the Cargo Delivery Order Item field.

See also, Cargo Bill Of Lading (on page 1).

 

Cargo Delivery Order Item

Displays a lookup field for the user to select the Delivery Order Item Number for the break-bulk gate transaction type. If the selected Delivery Order (on page 1) has only one order item, N4 automatically displays the order item in this field.

 

Cargo Appointment Qty

Displays a text field for a user to enter the quantity for the cargo appointment.

 

Cargo Item Quantity

Displays a text box to enable the user to enter the cargo lot quantity. This is the Quantity requested by the trucker that he intends to pick up.

For identified cargo lots, N4 assumes the cargo lot quantity equals 1.

If you configure the Appointment form to have the following quantity-related fields,

the value of the Cargo Appointment Qty entered in the Appointment form is populated in the Gate form's Cargo Item Quantity field.

Note: The value of the Cargo Item Quantity field in the Appointment form can be different from the value of the Cargo Item Quantity field in the Gate form.

Chassis Accessory Id

Displays a text field for the user to enter the chassis accessory number in an appointment form.

 

Chassis Equipment Type

Displays a lookup field of chassis types for the user to select from in the appointment form.

 

Chassis Is Owners

Displays a check box in an appointment form for the user to indicate if the trucking company is the owner of the chassis.

N4 gate currently does not do any validation of the "Chassis Is Owners" flag. If needed, this can be resolved with Groovy code.

 

Container Accessory Id

Displays a text field for the user to enter the container accessory number in an appointment form.

 

Chassis Id

Displays a text field for the user to enter the chassis number in an appointment form.

When a user enters an existing chassis number, the existing chassis type will pre-populate in the Chassis Equipment Type field, if displayed in the appointment form.

 

Hazardous

When you add this field in the Appt Tran Type form (on page 1) at the Appointment stage in your gate configuration and mark it as ‘Required’, N4 displays the Hazardous check box in the Appointment form (on page 1). Mark the Hazardous check box if you are creating an appointment for a hazardous container against a booking that is also hazardous.

For N4 to validate the appointment, you should have included the gate business task RejectTranNotMatchingHazardBooking at the Appointment stage (on page 1) for Receive Export (RE) transactions.

For details on how this validation works when you create an appointment using the Gate forms in N4 or through API, see Create and validate an appointment if a booking is hazardous.